home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / IMP_IMA.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  4.0 KB  |  88 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Import-Imagine
  3. .SH NAME
  4. imp_imagine \- Imagine or TTDDD geometry import filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the Imagine and TTDDD
  8. geometry import converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert an Imagine file to Wavefront using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i ima -o wave filename.iob
  16. .PP
  17. To convert an Imagine file to VRML and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i ima -in-ima-smoothing-angle = 40 -o vrml filename.iob
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. This geometry utility imports Imagine or TTDDD binary geometry files. All 
  25. geometry, surface attributes, hierarchy information, lights and cameras are 
  26. properly extracted from the file.
  27. .PP
  28. "Imagine" files typically have file extensions of ".iob", ".obj" or just 
  29. no extension at all. This converter expects that the file extension be 
  30. renamed to ".iob" so that the file type is not confused with the Wavefront 
  31. file type (which uses ".obj").
  32. .PP
  33. If any of the objects found in the file are reflective then a spherical 
  34. environment map will be added to the surfaces created for the reflective 
  35. objects. By default, all spherical environment maps will reference the texture 
  36. definition: 'imagine_sph_env_map_texture'
  37. .PP
  38. By default the texture definition uses the TIFF image called 'env_map.tif' 
  39. which is a dummy filename. You should change this to a nice reflective image 
  40. such as a sky or an image of chrome.
  41. .PP
  42. .SH COMMAND LINE OPTIONS
  43. .PP
  44. The following options are specific to this import converter:
  45. .TP
  46. -i ima
  47. This is the optional command line option which specifies that the input data
  48. is in the Imagine or TTDDD file formats. If not specified then the converter will try 
  49. to guess the input file's format from its file extension (.iob or .obj) and 
  50. then from the contents of its file. 
  51. .TP
  52. -in-ima-calcnormals = [ yes | no ]
  53. If set to 'yes' then new vertex normals will be computed for a polygon 
  54. if it does not have any vertex normals already. The smoothing criterion is 
  55. based on the angle between abutting polygons; common smoothed vertex normals 
  56. will be computed if the angle between their geometric surfaces normals is 
  57. less than the '-in-ima-smoothing-angle' angle described below. If set to
  58. 'no' then no new vertex normals will be created.
  59. .TP
  60. -in-ima-smoothing-angle = #
  61. This option sets the cut-off smoothing angle (in degrees) used by the vertex normal
  62. computation algorithm. If the angle between two abutting polygons is greater
  63. than this number then no smoothing will occur (a crease will be evident
  64. between the two polygons), else smoothing will occur where the polygons
  65. meet. The default angle is 30 degrees.
  66. .TP
  67. -in-ima-unify-normals = [ yes | no ]
  68. Most polygons in an Imagine scene file do not have a consistent orientation 
  69. (ie: some polygons are oriented clockwise while others are oriented counterclockwise). 
  70. In order for the '-in-ima-calcnormals' option to work all of the polygons 
  71. must have a consistent orientation. By setting this option to 'yes' the import 
  72. converter will walk across the polygon mesh and re-orient each polygon so 
  73. that it has the same orientation as its neighbouring polygon(s). Please note 
  74. that this will only work if neighbouring polygons share the same vertices.
  75. .TP
  76. -in-ima-orient-normals-outward = [ yes | no ]
  77. In some cases the '-in-ima-unify-normals' option above will 
  78. flip all of the geometric and vertex normals so that they point inwards 
  79. towards the center of each object. If this occurs then this option should be 
  80. set to 'yes' so that the normals point outwards.
  81. .PP
  82. .SH CREDITS
  83. .PP
  84. Portions of this converter are based on the T3D read/write library developed
  85. by Glenn Lewis, used by permission. He can be reached via email at
  86. glewis@pcocd2.intel.com or via his Internet WEB site at 
  87. http://www.c2.org/~glewis.
  88.